Launch Optimal Transfer Zone Slot Finder Job

Launches the Optimal Transfer Zone Slot Finder background job. This job calculates the optimal transfer zone (TZ) slots for containers in a work instruction (WI). You can use this job to find the optimal TZ slots for both Rail Load and Rail Discharge operations. If the N4 Opt Rail TZ Slot field is not set on the container, neither the dispatching client nor the rail TZ decker client attempts to process the move. Until the optimal slot is set by this background job, the EC Hold 'No Optimal Slot' is applied to the move, and the Hold State 'No Optimal Slot' is based on the Dispatch State. Once the rail TZ slot is assigned, the move is processed.

The background job loads all the WIs for the Rail Load and Rail Discharge operations, uses a geodetic API to find the closest TZ slot to the spotted/calculated position of the rail car. It then updates the Optimal TZ Slot field for the units associated with the WIs.

Use the ARGOECN4001 (TZ_SLOT_FINDER_FREQ) setting to configure this background job.

This job uses the OptimalTZSlotFinder system-seeded code extension of type RAIL_OPTIMAL_TZ_SLOT_FINDER to populate the N4 Opt Rail TZ Slot field for Rail Load and Rail Discharge moves.

If you override the system-seeded code extension, the new code extension must have the populateOptimalTZSlots() method (with return type void) that may call other methods or include business methods.

To launch this background job, you need the Background Jobs Actions - Launch Optimal Transfer Zone Finder Job privilege. To halt this job, you need the Background Jobs Actions - Halt Jobs privilege. See also, Background Jobs Privileges.

If you are using this background job with XPS, XPS Setting USN4TZ is required. USN4TZ is not required if you are using this background job with N4 Automation workflows.

This background job uses the EC Parameters RTZFZR and RTZNZR as inputs. See also: EC Parameter GENCHS.

The OptimalTZSlotFinder and abstract base Java classes and the ARGOECN4003 (TZ_SLOT_FINDER_WI_FREQUENCY) setting are deprecated for version 3.1 and above.